SK-3289: address Detect docs and sample parity feedback (Python) - #290

What

Addresses the final Detect feedback (docs + samples parity) for the Python SDKs — the items under Python (FlowVault) and Python (SkyVault), plus the shared nomenclature points. Docs/samples only; no SDK source changes.

flowvault README

• Remove the unsupported SKYFLOW_ID file source and state plainly that flowvault's DeidentifySourceType is BASE64/PRESIGNED_URL only (previously a copy-paste AttributeError).
• Document include_prefix / prefix_override on Entity and CustomType (incl. the include_prefix=NO "not re-identifiable" trap), and deidentification_type / destination on CustomType.
• Add where-to-create pointers (Studio / management API) for the configuration id, token groups and redaction patterns in Before you start.
• Add a Response examples and common errors section (sample JSON per shape + the common 400s).
• Make the re-identify example a round trip with a real vault token; branch re-identify-file on output_type (was an unconditional base64 decode + hardcoded .txt).

skyvault README

• Same re-identify round-trip fix (storing tokens in a table.column) and output_type branch.
• Add a bold warning that deidentify_file no longer waits by default.
• Note the server's default toxicity check; fix the stale v1 EOL banner (will reach → reached).

Samples (both SDKs)

• Print request_id in every Detect error handler.

Nomenclature

• Drop the "Detect V2" label from both READMEs and the flowvault samples README.
• Rename the migration guide to docs/migrate_detect.md, retitle it ("Migrate to the new Detect methods (skyflow 3.0.0)"), cite skyflow 3.0.0 in the intro + timeline, and promote the deidentify_file behaviour change to a top-of-doc warning.

Notes / decisions

• setup.py version is managed by release automation and is left unchanged; the guide now names 3.0.0 as the target — please confirm that's the release version.
• The guide's detailed method/field mapping tables still use "V1/V2" column labels (standard for a migration mapping, same as the Go guide); the customer-facing framing (title, intro, timeline) drops the V1/V2 nomenclature. Happy to scrub the body fully if preferred.

Verification

• All 12 Detect sample files compile (py_compile).
• No remaining Detect V2 / V2 API strings in the touched docs; no SKYFLOW_ID left in the flowvault README.

🤖 Generated with Claude Code